docs: Improve gtk_widget_set_font_map docs

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index ffd4ef4133dc9af3179c1c7e3b7c8302de027762..f9d5f079f9dd254344572e34a4ae3b765d35d97c 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -6209,8 +6209,12 @@ gtk_widget_set_font_map_recurse (GtkWidget *widget, gpointer user_data)
  * @font_map: (allow-none): a #PangoFontMap, or %NULL to unset any previously
  *     set font map
  *
- * Sets the font map to use for Pango rendering. When not set, the widget
- * will inherit the font map from its parent.
+ * Sets the font map to use for Pango rendering. The font map is the
+ * object that is used to look up fonts. Setting a custom font map
+ * can be useful in special situations, e.g. when you need to add
+ * application-specific fonts to the set of available fonts.
+ *
+ * When not set, the widget will inherit the font map from its parent.
  */
 void
 gtk_widget_set_font_map (GtkWidget    *widget,